Skip to content

feat: add refined-github-projects ECC bundle#49

Open
ecc-tools[bot] wants to merge 13 commits into
mainfrom
ecc-tools/refined-github-projects-1781444461944
Open

feat: add refined-github-projects ECC bundle#49
ecc-tools[bot] wants to merge 13 commits into
mainfrom
ecc-tools/refined-github-projects-1781444461944

Conversation

@ecc-tools

@ecc-tools ecc-tools Bot commented Jun 14, 2026

Copy link
Copy Markdown

Summary

Auto-generated ECC bundle from repository analysis.

What This Does

Merging this PR adds repo-local ECC artifacts for both Claude Code and Codex. The generated bundle captures repository patterns, Codex baseline config, and reusable workflow scaffolds derived from git history analysis.

Analysis Scope

  • Commit history patterns and conventions
  • Code architecture and structure
  • Testing patterns and coverage
  • Recurring workflows

Files

Path Description
.claude/ecc-tools.json ECC install manifest used for upgrades, repair, and uninstall.
.claude/skills/refined-github-projects/SKILL.md Repository-specific Claude Code skill generated from git history.
.agents/skills/refined-github-projects/SKILL.md Codex-facing copy of the generated repository skill.
.agents/skills/refined-github-projects/agents/openai.yaml Codex skill metadata so the repo skill appears cleanly in the skill interface.
.claude/identity.json Suggested identity.json baseline derived from repository conventions.
.codex/config.toml Repo-local Codex MCP and multi-agent baseline aligned with ECC defaults.
.codex/AGENTS.md Codex usage guide that points at the generated repo skill and workflow bundle.
.codex/agents/explorer.toml Read-only explorer role config for Codex multi-agent work.
.codex/agents/reviewer.toml Read-only reviewer role config focused on correctness and security.
.codex/agents/docs-researcher.toml Read-only docs researcher role config for API verification.
.claude/homunculus/instincts/inherited/refined-github-projects-instincts.yaml Continuous-learning instincts derived from repository patterns.
.claude/commands/modal-shell-refactor-or-bugfix.md Workflow command scaffold for modal-shell-refactor-or-bugfix.
.claude/commands/sprint-ui-enhancement-or-bugfix.md Workflow command scaffold for sprint-ui-enhancement-or-bugfix.
Optional: Continuous Learning (25 instincts)

This PR also includes instincts for the continuous-learning-v2 skill. These are optional and only useful if you use that skill.

Import after merging:

/instinct-import .claude/homunculus/instincts/inherited/refined-github-projects-instincts.yaml

Review Checklist

  • Verify detected patterns are accurate
  • Confirm generated config, commands, and skill metadata match the repo’s real workflow
  • Check best practices align with team standards before merging

ECC Tools | Everything Claude Code


Summary by cubic

Adds a repo-local ECC bundle that installs Claude Code and Codex skills, workflow commands, and agent configs aligned with this repo’s patterns. Improves repeatability for modal and sprint work and provides a safe Codex MCP baseline.

  • New Features

    • Repo skills for Claude Code and Codex: .claude/skills/refined-github-projects/SKILL.md, .agents/skills/refined-github-projects/SKILL.md (+ openai.yaml).
    • Workflow scaffolds: modal-shell-refactor-or-bugfix and sprint-ui-enhancement-or-bugfix in .claude/commands/.
    • Codex baseline at .codex/config.toml enabling github, @upstash/context7-mcp, exa, @modelcontextprotocol/server-memory, @playwright/mcp, and @modelcontextprotocol/server-sequential-thinking; multi-agent configs (explorer, reviewer, docs-researcher).
    • Identity baseline .claude/identity.json and optional continuous-learning instincts at .claude/homunculus/instincts/inherited/refined-github-projects-instincts.yaml.
    • ECC manifest .claude/ecc-tools.json to manage upgrades and repairs.
  • Migration

    • Optional: import instincts with /instinct-import .claude/homunculus/instincts/inherited/refined-github-projects-instincts.yaml.
    • Verify detected patterns and update the skill or commands if they differ from your workflow.
    • Keep private MCP credentials in ~/.codex/config.toml as noted in .codex/AGENTS.md.

Written for commit 069461b. Summary will update on new commits.

Review in cubic

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor auto review

Found 6 actionable issue(s) on changed lines.

The ECC bundle adds useful scaffolding, but the generated skill docs contain several high-confidence inaccuracies that will mislead agents: the skill body is wrapped in a markdown code fence, slash-command names don't match the committed workflow files, and the framework, ModalShell, and test examples don't match the repository.

Generated automatically when this PR was submitted using Cursor CLI with --model auto.

@@ -0,0 +1,104 @@
```markdown

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The entire skill is wrapped in a ```markdown fence (closed on line 104), so loaders will treat the instructions as a code block instead of skill content. Remove the outer fence so the file is plain markdown.


### Modal Shell Refactor or Bugfix
**Trigger:** When you need to refactor, consolidate, or fix modal UI logic and behavior.
**Command:** `/refactor-modal-shell`

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This references /refactor-modal-shell, but the generated command is /modal-shell-refactor-or-bugfix (see .claude/commands/modal-shell-refactor-or-bugfix.md and ecc-tools.json). Update the command name here and in the Commands table (lines 102–103) or agents will invoke a non-existent slash command.

## Coding Conventions

- **Language:** TypeScript
- **Framework:** None (vanilla React/TS)

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The repo is a WXT browser extension using React and @primer/react, not "vanilla React/TS". Document WXT + Primer so agents use the correct build/runtime patterns (pnpm dev, content scripts, Primer theming).

**Example:**
```typescript
// src/ui/modal-shell.tsx
export function ModalShell({ isOpen, onClose, children }) {

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This example API is incorrect: real ModalShell requires ariaLabel (not isOpen) and uses Primer Box/backdrop props, not className="modal-backdrop". Copy the signature from src/ui/modal-shell.tsx to avoid generating invalid modal code.

- **Test Example:**
```typescript
// src/ui/__tests__/modal-shell.test.tsx
import { render } from '@testing-library/react'

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The test example imports @testing-library/react, which is not a project dependency. Match src/ui/__tests__/modal-shell.test.tsx: Vitest plus react-dom/client createRoot, wrapped in Primer ThemeProvider/BaseStyles.


## Action

Use path aliases (@/, ~/) instead of relative imports

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The repo only uses the @/ path alias (see imports under src/); there are no ~/ imports. Drop ~/ from this instinct so agents don't introduce unsupported alias paths.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants